home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / dialm51.arc / DIALM51.DOC < prev    next >
Text File  |  1990-09-09  |  16KB  |  393 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                     DIALM
  8.                          A TELEPHONE DIALING PROGRAM
  9.                                 Revision 5.1
  10.                                 
  11.                                  Written by
  12.  
  13.                                Robert Wilcox
  14.                             920 N. Washington St
  15.                             Owosso, MI     48867
  16.   
  17.  
  18.    DIALM is a telephone dialing program which was written as an exercise in
  19.    programming for the Microsoft or compatible mouse.  It was later revised so
  20.    that the mouse is not required, and phone number file maintenance and the
  21.    ability to use multiple phone number files was added.  Revision 3.0 added
  22.    the use of dialing prefixes.  Revision 3.1 corrected a minor bug and 3.2
  23.    added a help screen.  With revision 4.0 DIALM has the ability to time and
  24.    log calls.  Revision 4.1 corrected a problem with sorting large dialing
  25.    directories.
  26.  
  27.    Revision 5.1 is a completely rewritten version.  It retains most of the
  28.    features of the earlier versions and has an improved user interface
  29.    because of the use of pop-up windows.  A better method of displaying
  30.    the phone number directory allows for a much faster number search.
  31.   
  32.    DIALM runs on an IBM PC, XT or AT or compatible computer.  It requires
  33.    a HAYES or HAYES compatible modem on either port COM1 or COM2.  The program
  34.    will run without a modem, but of course dialing will not be possible.
  35.    A mouse is useful but not required.
  36.  
  37.  
  38.                                ================
  39.                                PROGRAM FEATURES
  40.                                ================
  41.    
  42.    DIALING DIRECTORIES
  43.    ===================
  44.    DIALM uses a telephone number directory file stored on disk which is
  45.    created and updated from within the program.  The directory may contain 
  46.    up to 200 entries.  Each entry contains a name, the number and an address
  47.    or other descriptive string.  Any number of directory files may be available
  48.    on disk and the one to be used can be selected from the command line or
  49.    after the program is running.
  50.  
  51.    Directory files may be on any drive or sub-directory.  The program will look
  52.    for directory files on the default drive and sub-directory unless otherwise
  53.    specified (see below).  Other drives and sub-directories can be easily
  54.    selected.
  55.    
  56.    DIALM 5.1 will use dialing directories created with any previous version
  57.    of DIALM version 3.0 or higher.
  58.  
  59.  
  60.    SELECTING A NUMBER TO DIAL
  61.    ==========================
  62.    A number to be dialed may be selected by clicking on it with the mouse or
  63.    by pressing the ENTER key when the desired entry is displayed.  Pressing
  64.    a letter key will display the entry beginning with that letter.  Subsequent
  65.    pressings of the same letter will advance to the next entry beginning with
  66.    that letter.
  67.  
  68.    Entries may be searched for from the main menu also.  A search string is
  69.    entered and the name and description fields of each entry are searched
  70.    for a match.
  71.  
  72.    A number to be dialed may also be entered from the keyboard. 
  73.  
  74.    PREFIXES
  75.    ========
  76.    Ten dialing prefixes (A through J) are stored by the program and are
  77.    created by the user.  For instance, prefix A might be "1-800", then
  78.    the number A-555-1212 would be dialed as 1-800-555-1212.
  79.  
  80.    LOGGING
  81.    =======
  82.    A log record of calls can be maintained which will show the date, time
  83.    and length of calls.  The user may type, copy or print this file from
  84.    the command line since it is a standard ASCII (text) file.  The log
  85.    file is called "DIALM.LOG" and is stored in the root directory of the
  86.    default drive.
  87.  
  88.  
  89.                         ==========================
  90.                         PROGRAM FEATURES CONTINUED
  91.                         ==========================
  92.  
  93.    ATTACK (DEMON) DIALING
  94.    =======================
  95.    When a number is dialed which is busy the program will attempt to re-dial it
  96.    after a short pause, up to 25 times.
  97.  
  98.    SCREEN BLANKING
  99.    ===============
  100.    You may select to have the screen go blank after 5 minutes of inactivity
  101.    while in the main menu or number select menu.  When the screen is blank,
  102.    pressing any key or mouse button will restore the screen.
  103.  
  104.    CALENDAR
  105.    ========
  106.    A calendar of the present month can be selected from the main menu or from
  107.    the logging screen.  The month and year can be advanced or backed up by
  108.    using the arrow keys or clicking on the arrows with the mouse.
  109.  
  110.    PROGRAM SETUP
  111.    =============
  112.    The program uses color and sound.  These features can be disabled.  
  113.    The selection of either pulse or tone dialing also may be made and screen 
  114.    blanking can be selected.  The modem initialization string can also be
  115.    entered if needed. 
  116.  
  117.    Program configuration information is kept in the dialing directory 
  118.    presently in use.  In other words, each dialing directory may be set up 
  119.    differently.
  120.  
  121.    
  122.  
  123.                         ==========================
  124.                         PROGRAM FEATURES CONTINUED
  125.                         ==========================
  126.  
  127.  
  128.    POP-UP MENUS
  129.    ============
  130.    DIALM uses pop-up menus and other windows.  Some of these are illustrated
  131.    below.
  132.  
  133. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  134.                                                                                 
  135.                       DIALM POPUP TELEPHONE DIALER   Ver. 5.1             
  136.                                                                                 
  137. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀╒══════════════════════════╕▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  138. ══════════════════════════════════════│    COMMAND SELECTIONS    │══════════════
  139.                                       │══════════════════════════│
  140.                                       │DIAL SELECTED NUMBER      │
  141.                                       │HANGUP                    │
  142.                                       │SELECT A NUMBER           │
  143.                                       │SEARCH THE DIRECTORY      │
  144.                                       │REPEAT THE SEARCH         │
  145.                                       │UPDATE THE DIRECTORY      │
  146.                                       │NUMBER FROM KEYBOARD      │
  147.                                       │EDIT PREFIXES             │
  148.                                       │LOG THIS CALL             │
  149.                                       │GET NEW DIRECTORY         │
  150.                                       │PROGRAM SETUP AND INFO    │
  151.                                       │QUIT THIS PROGRAM         │
  152.                                       ╘══════════════════════════╛
  153.  
  154. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  155.  
  156.                      DIALM POPUP TELEPHONE DIALER   Ver. 5.1 
  157.  
  158. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀╒══════════════════════════╕▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  159. ══════════════════════════════════════│    COMMAND SELECTIONS    │══════════════
  160.                                       │══════════════════════════│
  161.                   ╒═════════════════════════╕ELECTED NUMBER      │
  162.                   │    DIRECTORY = DIALM    │                    │
  163.                   │═════════  ═  ═════════│ A NUMBER           │
  164.                   │Arrow Electronics        │ THE DIRECTORY      │
  165.                   │Brush Hauling            │ THE SEARCH         │
  166.   ┌──────────┐    │Corunna TV               │ THE DIRECTORY      │
  167.   │ Main Menu│    │Eavestroughs             │ FROM KEYBOARD      │
  168.   │          │    │FAB Software             │REFIXES             │
  169.   │  [ESC]   │    │Free Press               │IS CALL             │
  170.   └──────────┘    │GTE Telephone Co         │W DIRECTORY         │
  171.                   │H&R Block                │M SETUP AND INFO    │
  172.                   │Hard Drive Int           │HIS PROGRAM         │
  173.                   │Info 313                 │════════════════════╛
  174.                   ╘═════════  ═  ═════════╛
  175.  
  176.  
  177.  
  178.  
  179.                                                                                 
  180.                                ============== 
  181.                                STARTING DIALM
  182.                                ==============
  183.  
  184.    If the version of the program as you obtain it is "DIALM51.EXE" you
  185.    may rename it "DIAL.EXE" for brevity.  At the DOS prompt type:
  186.  
  187.         REN DIALM51.EXE DIALM.EXE
  188.  
  189.    To start DIALM type:
  190.  
  191.         DIALM [CR] 
  192.  
  193.    where [CR] means press the RETURN button.
  194.  
  195.    If the screen is hard to read because it doesn't display color correctly,
  196.    use the command line parameter "/B" to force the program to use black and
  197.    white, i.e.,
  198.  
  199.         DIALM /B [CR]
  200.  
  201.    A directory file name may also be entered on the command line.  If one
  202.    is entered the program will attempt to use the file.
  203.  
  204.        DIALM C:\DAT\PHONES [CR]
  205.  
  206.    This will load in the directory file named PHONES.DIR in the sub-directory
  207.    DAT of drive C.
  208.  
  209.    If the /B parameter is also used, leave a space between it and the directory
  210.    file name.
  211.  
  212.  
  213.  
  214.                                                                                 
  215.                                ===================
  216.                                USING DIALM'S MENUS
  217.                                ===================
  218.  
  219.    There are several ways to make a selection from the menus:
  220.  
  221.       1)  Press ENTER or click the left mouse button to select the high-
  222.           lighted entry.
  223.  
  224.       2)  Move the mouse cursor over the desired entry and click the left
  225.           button to highlight the entry.  Click it again on the same entry
  226.           to select it.
  227.  
  228.       3)  Press the first letter of the desired selection on the keyboard.
  229.           If there are two or more selections with the same first letter,
  230.           pressing the letter again will move to the next selection starting
  231.           with that letter.  When the correct selection is highlighted, press
  232.           ENTER or the left mouse button.
  233.  
  234.       4)  Use the PAGE UP, PAGE DOWN, HOME, END and arrow keys until the
  235.           desired selection is highlighted, then press ENTER or the left 
  236.           mouse button.
  237.  
  238.    The directory display menu shows 10 entries at a time.  If there are
  239.    more entries available,  arrow characters will appear in the top and
  240.    bottom borders of the menu.  Clicking the left mouse button on an
  241.    arrow character will execute the appropriate page-up or page-down
  242.    command.
  243.  
  244.    The ESC (escape) keyboard key has special meaning in some menus.
  245.    Pressing the right mouse button is the same as the ESC key.
  246.    Moving the mouse cursor outside of the menu area and pressing the
  247.    left button is also the same as the ESC key.  In some menus ESC
  248.    will cause the QUIT command to be highlighted.  This allows mouse
  249.    users to exit the menu or program by clicking the right button
  250.    followed by the left button.
  251.  
  252.  
  253.                                 ==============
  254.                                 ERROR MESSAGES
  255.                                 ==============
  256.  
  257.    Sometimes a message will appear followed by a several second delay.
  258.    You may press ESC on the keyboard or click the right mouse button to
  259.    speed things up after you have read the message.
  260.  
  261.  
  262.  
  263.  
  264.                                ====================
  265.                                ENVIRONMENT COMMANDS
  266.                                ====================
  267.  
  268.    Three program parameters can be set up at the DOS level and if set DIALM
  269.    will use these parameters automatically each time the program is run.
  270.  
  271.       1) Modem (COM) port.
  272.          DIALM will find the modem on either COM1 or COM2 (usually).  If your
  273.          modem is on COM2 you can speed things up by putting the port number
  274.          in the environment.  At the DOS prompt type:
  275.  
  276.                 SET COMPORT=2
  277.  
  278.       2) Modem baud
  279.          The program communicates with the modem at 1200 baud because that 
  280.          seemed to work better for my particular modem.  If your modem doesn't
  281.          work at 1200 baud you can specify another baud (such as 300 baud) by 
  282.          the following command:
  283.  
  284.                 SET COMPORT=:300
  285.  
  286.          If you want to specify both the port and the baud, combine the
  287.          commands:
  288.  
  289.                 SET COMPORT=2:300
  290.    
  291.          This program supports only COM1 and COM2 modem ports.
  292.  
  293.       3)  Directory file
  294.           You may specify a directory file to be used by DIALM.  This file will
  295.           be used unless overridden by a command line parameter described above.
  296.  
  297.                SET DIAL=C:\PHONE.DIR
  298.  
  299.          You should use the correct path and file name to describe your file
  300.          after the '='.
  301.  
  302.  
  303.    If you use this program regularly and need to use the SET commands mentioned
  304.    above, they should be placed in your AUTOEXEC.BAT file so they will not have
  305.    to be entered each time the system is booted up.
  306.  
  307.    If you get the error message OUT OF ENVIRONMENT SPACE, and you are using
  308.    DOS 3.2 or later, put the following line in your CONFIG.SYS FILE:
  309.  
  310.    SHELL=d:\COMMAND.COM /P /E:256
  311.  
  312.    Where d:\ is the drive and directory where your COMMAND.COM is located.
  313.    (This will probably be C:\ if you have a hard disk or A:\ if you boot from
  314.    a floppy disk.)  The environment space where the SET variables are stored
  315.    will be increased from the default 160 bytes to 256 bytes.
  316.  
  317.    If you are using DOS 3.1, use /E:16 instead of /E:256.
  318.    
  319.    If you are using DOS earlier than 3.1 the environment space can only be
  320.    increased by patching COMMAND.COM.
  321.  
  322.  
  323.  
  324.                                   ======
  325.                                   MODEMS
  326.                                   ======
  327.  
  328.    The modem should use the "HAYES AT" commands.  A initialization string
  329.    can be stored in the dialing directory and sent to the modem each time
  330.    the directory is loaded.  Here are some common initialization commands:
  331.  
  332.       AT   Attention - must start the command string.
  333.       E1   Echo all commands.
  334.       Q0   Result codes ON.
  335.       V1   Result codes are verbal rather than numeric.
  336.       X6   Wait for dialtone.  "NO DIALTONE" and "BUSY" results enabled.
  337.  
  338.    Not all modems will accept the X6 initialization.  Please consult your
  339.    modem manual.  If your modem issues "NO DIALTONE", "BUSY" and "RINGING"
  340.    result codes they should be enabled as DIALM will recognize them.
  341.       
  342.    Use of an initialization string will override any switch settings on the
  343.    modem.
  344.  
  345.    DIALM was tested using a 2400 baud "HAYES compatible"  modem.
  346.  
  347.  
  348.                                   =======
  349.                                   SUPPORT
  350.                                   =======
  351.  
  352.    I would be interested in hearing of any problems with the program and
  353.    will attempt to fix them in a later release.
  354.  
  355.    DIALM is distributed as user-supported software.  If you find the program
  356.    is useful you may send a donation of $5.00 to:
  357.  
  358.  
  359.  
  360.                         Robert Wilcox
  361.                         920 N. Washington St
  362.                         Owosso, MI     48867
  363.  
  364.    I can be reached through the EXEC-PC bulletin board (414) 789-4120.
  365.    Address messages to: BOB WILCOX.
  366.  
  367.    My Compuserve address is 71601,1541.
  368.  
  369.                             ==========================
  370.                             WARRANTIES AND LIMITATIONS
  371.                             ==========================
  372.  
  373.    You are granted permission to freely distribute DIALM in its
  374.    original form, without alteration, so long as this documentation is
  375.    distributed along with it and no fee is charged except for a reasonable
  376.    fee for media and shipping costs.
  377.  
  378.    I suggest that you distribute in the original ZIPped format.
  379.  
  380.    I DO NOT WARRANT THAT DIALM IS FIT FOR ANY PARTICULAR USE OR IS
  381.    MERCHANTABLE.  THIS PROGRAM IS NOT WARRANTED TO BE FREE OF BUGS, NOR
  382.    IS IT PROVIDED WITH ANY WARRANTY OF ANY KIND, EITHER EXPRESSED OR
  383.    IMPLIED.  IT IS YOUR RESPONSIBILITY TO DETERMINE WHETHER DIALM
  384.    IS SUITABLE FOR YOU.
  385.  
  386.    IN NO EVENT SHALL I BE HELD RESPONSIBLE FOR INCIDENTAL, SPECIAL OR
  387.    CONSEQUENTIAL DAMAGES, OR LOST DATA OR PROFITS TO ANY PERSON OR ENTITY
  388.    THAT MAY ARISE OUT OF THE USE OF THIS PROGRAM.
  389.  
  390. END OF DIALM.DOC                                     LAST REVISED 09/02/90
  391.  
  392.  
  393.